home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / gen_bbs / dk-nodes.zip / NODES.DOC < prev    next >
Text File  |  1996-12-17  |  4KB  |  107 lines
  1.                     Nodes Monitor for Telegard 3.00+
  2.                      Version 0.01 alpha - 12/16/96
  3.  
  4.  
  5. Disclaimer
  6. ----------
  7.  
  8.         This program comes with no guarantees.  If it damages, destroys
  9. or modifies your system in any way you are ultimately responsible, not
  10. me.  I will not be held accountable for any damages to your life or your
  11. property which arise from the use or misuse of this program.  You have
  12. been forewarned.
  13.  
  14. Purpose
  15. -------
  16.  
  17.         A sysop in the FidoNet Telegard Support echo asked if someone
  18. would program a command-line utility which he could use to monitor the
  19. activity of each node.  I had just gotten back from my Grade 11 English
  20. exam at 12:30 in the afternoon when I read his message.  I was bored, so
  21. I started coding... Now, at 2:00 in the morning I'm finally writing the
  22. documentation for the program.  I didn't spend ten hours on this
  23. program; I spent about one.  It wasn't difficult to code and I enjoyed
  24. programming it.
  25.  
  26. Usage
  27. -----
  28.  
  29.         This program, when run from the command-line with the
  30. appropriate parameters, will display the activity for each node which
  31. exists in the NODES.DAT file.  It will display the node number, the
  32. user's name (or handle, if that option is turned on in the Telegard
  33. configuration), what each node is doing, the logon time and the baud
  34. rate.  It will also display two flags, for users who are logged in as
  35. invisible users or those who do not want to be disturbed.  I don't know
  36. if these options are supported in Telegard 3.02; they've been coded in
  37. anyways.
  38.  
  39.     Command-line parameters and the program's syntax are as follows:
  40.  
  41.         NODES.EXE       <full path to CONFIG.TG>        <polling value>
  42.  
  43.         The first parameter should point to where the CONFIG.TG file is
  44. located.  This is a _FULL_ path.  Don't enter "C:\TG\" or anything like
  45. that, have it point to "C:\TG\CONFIG.TG" or else it will not work.
  46.         The second parameter defines how long the program will wait
  47. before each read of the NODES.DAT file.  For example, if the polling
  48. value was set to 20, the program would read in the NODES.DAT datafile
  49. every 20 seconds.  This parameter is optional.  If it is not specified,
  50. a value will be taken from CONFIG.TG and used instead.  This value
  51. corresponds to how long each node will wait before updating the
  52. NODES.DAT file.
  53.  
  54.     Examples:
  55.  
  56.         NODES.EXE C:\TG\CONFIG.TG
  57.                 - Load up the node monitor with the default value and
  58.                   the specified file (C:\TG\CONFIG.TG)
  59.         NODES.EXE C:\TG\CONFIG.TG 5
  60.                 - Load up the node monitor and have it use
  61.                   C:\TG\CONFIG.TG as the BBS setup file.  It will also
  62.                   wait five seconds between each read of the NODES.DAT
  63.                   file.
  64.  
  65. Multi-Node
  66. ----------
  67.  
  68.         Obviously, this program uses multi-node routines.  If you don't
  69. have SHARE.EXE (or a similar program) loaded, I suggest you load it as
  70. file locking will not work properly.  I have tested this program to the
  71. best of my abilities.  If you have bugs, please send me the run-time
  72. error number and the offset (eg. FFFF:FFFF) at which the error occurred.
  73. If you can, I'd also like a description of what was going on at the time
  74. of the error.  I can be reached as folllows:
  75.  
  76.         Name     : Mustapha Mond, AKA Darkness
  77.         BBS      : Pointbreak (613-569-0151)
  78.         FidoNet  : 1:163/422
  79.         Internet : darkness@pointbrk.erkware.com
  80.  
  81. If you're a decent person...
  82. ----------------------------
  83.  
  84.         This program wasn't a very big deal at all and is distributed as
  85. freeware, but if you want to send me something for my troubles here's my
  86. mailing address:
  87.  
  88.         Pointbreak Systems
  89.         181 Second Avenue
  90.         Ottawa, Ontario
  91.         K1S 2H6
  92.  
  93.         Feel free to send me money, postcards, letters suggesting
  94. changes and reporting bugs, gift-certificates or coupons,
  95. priceless works of art, expensive cars, etc... I can't give you anything
  96. in return, but hey.. you'll make my day. :)
  97.  
  98.  
  99. Planned Features
  100. ----------------
  101.  
  102.         If I ever have another two hours of spare time on my hands I'll
  103. see if I can program an editor for the NODES.DAT file into the node
  104. monitor.  I make no promises, though.
  105.  
  106.                                         12/16/96
  107.